Star_JavaPOS_Driver_linux
Ver 1.13.13
---------------------------------------


Package Contents:
    . starjavapos.jar
    . stario.jar
    . jpos113-controls.jar
    . jcl.jar
    . xercesimpl.jar
    . xml-apis.jar
    . jpos.xml
    . StarReceiptTest.java
    . StarCashDrawerTest.java
    . star.gif
    . StarIOPort_Install_x32(x64)
    . SoftwareLicenseAgreement.pdf
    . SoftwareLicenseAgreement_jp.pdf
    . SoftwareLicenseAgreementAppendix.pdf
    . readme_en.txt
    . readme_jp.txt
    . 49-starusbprn.rules
    . DiscoveryTool


Supported Operating Systems:
    The evaluation environment is as follows:
        Red Hat Enterprise Linux 8.3 (64bit)
        openSUSE Leap 15.3 (64bit)
        Fedora 34 (64bit)
        Ubuntu 16.04LTS (32bit) / 20.04 LTS (64bit)
        CentOS 8.4 (64bit)

Java Virtual Machine Requirement:
    Java2 Standard Edition 1.4.2 or higher

    NOTE: We recommend using Java2 Standard Edition 5.0 or higher


Preparation - Installing StarIOPort
    Browse to the StarJavaPOS directory "StarIOPort_Install_x32(x64)" and run the bash script named
    "install.sh". To run it, login as root and issue this command in the terminal "/bin/bash install.sh" 
    once you change to this  directory. This will copy the library file to the "/usr/lib(64)" directory and
    header file to the "/usr/include" directory.
    
    e.g) Ubuntu x64
    [j2@localhost starjavapos_1.13.nn_linux_64bit_yyyymmdd]$ cd StarIOPort_Install_x64/
    [j2@localhost StarIOPort_Install_x64]$ sudo /bin/bash install.sh
    Complete!

    Note:
    StarIOPort is installed in the following locations
    /usr/lib or /usr/lib64
    Make sure that the above path is added to the LD_LIBRARY_PATH environment variable.


Configuration Sample - jpos.xml:
    StarJavaPOS uses the JCL - Java Configuration Loader system for
    configuring the provided services.  The file jpos.xml contained
    in this package has been initialized with device entries for
    Star's newest printer products.

    The following is a list of the POSPrinter device entries
    contained in this file as indexed by their logicalName field:
        . POSPrinter_linux_usb_printer_class
        . POSPrinter_linux_ethernet
        . POSPrinter_linux_bluetooth

    The following is a list of the CashDrawer device entries
    contained in this file as indexed by their logicalName field:
        . CashDrawer_linux_usb_printer_class
        . CashDrawer_linux_ethernet
        . CashDrawer_linux_bluetooth

    The following is an adding property of POSPrinter
        . useNVBitImage
        example:  <prop name="useNVBitImage" type="Boolean" value="true" />
    NOTE: If "useNVLogoImage property" set the "true", can use "NV Logo Print" by escape sequence(ESC | # B). 

    Please refer to starjavapos_driver_sm_en.pdf for details.


Usage - Test Application:
    Open StarReceiptTest.java and StarCashDrawerTest.java.
    Then, refer to the usage instructions.


Restrictions and Cautions
    When using a Bluetooth printer, printing may not be possible after recovery if the printer's power is turned off during printing.
    In that case, it is possible to recover by turning the printer off and then on again, or turning Bluetooth off and on again on your PC.
    If it doesn't recover at one time, please retry it.


Release History

18/06/2018 First Release.
Ver 1.13.10

04/09/2019 Bug Fix:cannot control multiple CashDrawer devices simultaneously.
ver1.13.11

27/08/2019  Integrated JavaPOS Driver for mCollection and Portable.
Ver 1.13.12  - Add support MCP30.

24/04/2020    Added support MCP31C, MCP31CB. (mC-Print3 Series)
Ver 1.13.12.2

29/10/2021    Added support TSP100V.
Ver 1.13.13
